home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 30.zip / BS1 part 30 / MasterSecaV1.93.adf / tjseka.doc < prev    next >
Encoding:
Text File  |  1977-12-31  |  9.9 KB  |  323 lines
  1. ;----------------------------------------------------------------------
  2. ;
  3. ;    T.J. >>> The Phantastograph <<< BERLIN presents the NEW
  4. ;
  5. ;    MASTERSEKA V1.90 / 01
  6. ;
  7. ;
  8. ;    Versionänderungserklärungen stehen ganz unten !!!
  9. ;
  10. ;    Alle Seka-Versionen die als Process laufen,hatten einen grossen
  11. ;    Fehler.Man konnte die Dos-Routine OUTPUT() nicht fehlerfrei
  12. ;    anwenden.Diesen Fehler habe ich nun endlich behoben.Moechte
  13. ;    bloss wissen wer auf die Schnapsidee kam,in der Process-
  14. ;    Struktur den Standart Ein/Ausgabe Pointer auf Null zu setzen,
  15. ;    statt sie richtig zu beschreiben.TJ
  16. ;
  17. ;    Anleitung zur verbesserten Seka-Version V1.54 und V1.6
  18. ;    Einige Requester wie z.B. Chip/Fast u.s.w habe ich nicht mit
  19. ;    eingebaut.Sie wurden von mir als stoerend empfunden.
  20. ;    Wichtig aber sind z.b. die File-Requester und der
  21. ;    Directory-Requester.Ein neuer Requester wurde von mir 
  22. ;    mit einintegriert,der Notiz-Requester.Man hat auch die
  23. ;    Moeglichkeit SEKA-Befehle in diesen Requester einzugeben
  24. ;    und mit Rechter-Alt-Taste und Help-Taste auszufuehren.
  25. ;
  26. ;    Beispiel:  cls\q$50000\q$60000\n$4\      Der \ verursacht
  27. ;                         ein RETURN + Leerzeile
  28. ;
  29. ;    Beispiel:  cls|q$50000|q$60000|n$4|     Der | verursacht
  30. ;                         ein RETURN ohne
  31. ;                         Leerzeile
  32. ;    Ohne \ oder | koennen keine Befehle
  33. ;    im Notiz-Requester ausgefuehrt werden !
  34. ;    ---------------------------------------------------------------
  35. ;
  36. ;    Die Notizen können mit RAmiga-Help-Taste abgespeichert werden.
  37. ;
  38. ;    Die Notizen können voreingestellt werden.Dazu ist in der
  39. ;    Masterseka.Startup Datei der Parameter -n anzugeben.Danach folgt
  40. ;    der Text,der unbedingt mit ! zu beenden ist.Wird das ! vergessen,
  41. ;    kann es zum Absturz führen.Die maximale Textlänge darf 160 nicht
  42. ;    überschreiten!!!
  43. ;
  44. ;    Beispiel:
  45. ;
  46. ;    -n
  47. ;    Heute ist ein schöner Tag zum hacken.
  48. ;    Amiga is the best.!
  49. ;
  50. ;
  51. ;
  52. ;    Achtung vom Gebrauch -m 006 fff 111 222!
  53. ;    Der Parameter -m erlaubt eine Voreinstellung der RGB-Palette für
  54. ;    die Palette 0,1,2,3.Im obigen Beispiel hat Pal0 die Farbe 006,
  55. ;    Pal1 = fff,Pal2 = 111,Pal3 = 222.Es sind bei 1er Bitplane natürlich
  56. ;    nur die Paletten 0 und 1 gültig.
  57. ;    Ganz besonders wichtig ist,das nach -m ein space steht,und am Schluss
  58. ;    der Eingabe direkt ein Ausrufezeichen (!).Siehe oben.
  59. ;
  60. ;
  61. ;
  62. ;    Alle Neuen Befehle sind in der Erklaerung mit NEW -> bezeichnet.
  63. ;    
  64. ;
  65. ;----------------------------------------------------------------------
  66.  
  67.  
  68.  
  69.     Bitte die req.library V1.22 benutzen.Ältere Versionen könnten nicht
  70.     funktionieren.
  71.  
  72.  
  73.  
  74. CLI and/or 'MasterSeka.startup' file options
  75. --------------------------------------------
  76.  
  77.     Syntax (with '-')         Explanation
  78.     ---------------------------------------------------------------
  79.     -a AbsoluteAdr        : Workspace at Adr
  80.     -b Scrollbarflag    : flag: 0=none, 1=right, 2= left border
  81.     -c            : Workspace in Chipmemory
  82. NEW ->    -d            : Turns off the menu-display starting
  83.                 ; the seka,but calling it with hl.
  84.     -e Editorsize        : size: number of editor lines
  85. NEW ->    -f             : If using this Parameter,your F-Keys
  86.                 ; have normal Functions (h0),else you can
  87.                 ; use them as Marker-Keys (h1)
  88.     -h Historysize        : size: history size (default: 127)
  89.     -l flag            : flag: 0=linenumbers off 1=on
  90. NEW ->  -m            : -m 0f0 a64 b00 047!
  91.                 : Parameter for RGB-Palette ended with !
  92.                 : (Pal 0,Pal 1,Pal 2,Pal 3)
  93. NEW ->    -n text!        ; Text for Notice-Requester must ending with !
  94.     -r            : Use REQ.LIBRARY Filerequester
  95.     -s Screendepth        : depth: 0=window, 1=1 plane, 2=2 planes
  96. NEW ->    -t             : Turns off the Sound after you assemble
  97.                 ; a program.Normally its on. 
  98.     -w X Y Width Heigth    : Size of window (set either parameter to
  99.                   0 to use its default, use PAL/NTSC size
  100.     -w+ X Y Width Heigth    : Dito, but use workbench screen size
  101.     -X            : Close workbench (only when start from WB)
  102.  
  103.  
  104. MasterSeka commands (optional parameters in '[' and ']')
  105. --------------------------------------------------------
  106.     !            : Quit/Restart Seka
  107. NEW ->    :            : Quit Seka quickly
  108.     =            : WorkInfo
  109.     >[<SPACE>Filename]    : Copy output to file (close file with '>'!)
  110.     ?            : evaluate expression
  111.     @[Command]        : execute CLI command
  112.     a[Address]        : assemble (for options: see below)
  113.     b            : bottom
  114.     bAddress        : calculate bootblock checksum for Address
  115.     c            : compare memory ranges
  116.     cl            : kill source
  117.     cls            : clear screen
  118.     d[Address]        : dissassemble
  119.     e[Line number]        : edit line
  120.     f            : find in memory
  121.     fi            : fill memory
  122.     g[Address]        : jump to address
  123. NEW ->    h            : System Pointer
  124. NEW ->    hh            : System Pointer without cls
  125. NEW ->    h0            : Turn to normal F-Keys (SETMAP)
  126. NEW ->    h1            : Turn to Marker F-Keys (EDITOR)
  127. NEW ->    hl            : Show Menu
  128.     i[Line number]        : insert line
  129.     j[Address]        : JSR to address
  130.     ka            : free absolute memorylist (see 'INCBIN')
  131.     kf[<SPACE>Filename]    : delete file
  132.     kl            : kill linkfile in memory
  133.     kp            : kill paste buffer
  134.     ks            : kill source
  135.     l[Searchstring]        : search source for searchstring
  136.     m[Address]        : modify memory
  137.     n[Address]        : show ASCII dump
  138.     o            : old (get source back after 'ks')
  139.     p[Amount]        : display 'Amount' sourcelines from current
  140.     q[Address]        : hexdump memory
  141.     r[<SPACE>Filename]    : read source
  142.     ri[<SPACE>Filename]    : read binary file
  143.     rl[<SPACE>Filename]    : read link file
  144.     ro[<SPACE>Filename]    : read executable (LoadSeg)
  145.     rs[Drivenumber]        : read sectors
  146.     rt[Drivenumber]        : read cylinders
  147. NEW ->    rgb            : Color Requester
  148. NEW ->    s0            : Sound after assemble off
  149. NEW ->    s1            : Sound after assemble on
  150.     s[Address]        : single step code
  151.     t[Linenumber]        : jump to top of source or specified line
  152.     u[Address]        : UnloadSeg executable
  153.     v[Pathname]        : show directory
  154.     v<SPACE>Pathname    : change directory
  155. NEW ->    vv            ; Direktory with File-Requester
  156.     w[<SPACE>Filename]    : write source
  157.     wbFlag            : Flag: 0=Close WB, 1=Open WB
  158.     wi[<SPACE>Filename]    : write binary file
  159.     wl[<SPACE>Filename]    : write link file
  160.     wo[<SPACE>Filename]    : write executable
  161.     ws[Drivenumber]        : write sectors
  162.     wt[Drivenumber]        : write cylinders
  163.     y            : load EXTERNS
  164.     zAmount            : zap 'Amount' lines
  165.  
  166.  
  167. assemble options
  168. ----------------
  169.     A    :    Error on absolute memory adr mode (for debugging)
  170.     E    :    Listing on printer
  171.     H    :    Stop after each page of the listing
  172.     L    :    Produce linkable code
  173.     O    :    Optimize
  174.     P    :    Listing on printer (same as E)
  175.     R    :    Error on reloc entry (non pc-relative code)
  176.     V    :    Listing on screen
  177.  
  178.  
  179. Shortcuts with Amiga-key (Direct mode marked with a '*')
  180. --------------------------------------------------------
  181.     a    :    Search previous occurence
  182.     A    :    Assemble quickly (no options specified)
  183.     b    :    Mark block
  184.     c    :    Copy block
  185.     g    :    Goto line
  186.     i/l    :    Insert block
  187.     k    :    Cut line
  188.     *q    :    Quit MasterSeka
  189.     q    :    Quit editor
  190.     r    :    Replace next occurence
  191.     R    :    Replace ...
  192.     s    :    Search next occurence
  193.     S    :    Search ...
  194.     t    :    Top of file
  195.     T    :    Bottom of file
  196.     u    :    Block to lowercase
  197.     U    :    Block to uppercase
  198.     w    :    Save block
  199.     x    :    Cut block
  200.     y    :    Cut to end of line
  201.  
  202.  
  203. Shortcuts with CTRL-key:
  204. ------------------------
  205.     A    :    One screen up
  206.     B    :    Mark block
  207.     C    :    Cut block
  208.     D    :    Delete to end of lines
  209.     E    :    Cursor to End of Line
  210.     F    :    Paste block (fill)
  211.     J    :    Search for text (jump)
  212.     K    :    Kill line
  213.     L    :    Lower case
  214.     O    :    Insert line
  215.     P    :    Paste
  216.     Q    :    Cursor to Start of Line
  217.     R    :    Rotate block
  218.     S    :    100 lines up
  219.     T    :    Top of File
  220.     U    :    Upper case
  221.     W    :    Write block to disk
  222.     X    :    100 lines down
  223.     Y    :    One screen down
  224.     Z    :        "
  225.     [    :    ESC
  226. NEW ->  HELP    :    Remark-Requester
  227.  
  228.  
  229. Shortcuts with CTRL-LShift-Key:
  230. -------------------------------
  231.  
  232. NEW ->    HELP    :    System Pointer
  233.  
  234.  
  235. Shortcuts with LALT-Key:
  236. ------------------------
  237.  
  238. NEW ->    HELP    :    Color Requester
  239.  
  240.  
  241. Shortcuts with RALT-Key:
  242. ------------------------
  243.  
  244. NEW ->    HELP    :    Execute Statements written in Remark Requester
  245.  
  246.  
  247. Shortcuts with RAmiga-Key:
  248. ------------------------
  249.  
  250. NEW ->    HELP    :    Save Notizen
  251.  
  252.  
  253. Pseudo opcodes (directives)
  254. ---------------------------
  255.     Syntax            : Explanation        : Example
  256. --------------------------------------------------------------------------
  257.     align Size[,Offset]    : align PC        : align 32
  258.     blk.B/W/L Size[,Code]    : fill block        : blk.b 100,'C'
  259.     code            : code section        :
  260.     cnop Size[,Offset]    : see 'align'        :
  261.     dc.B/W/L Size[,Code]    : insert constants    : dc.b "CORSAIR"
  262.     ds.B/W/L Size[,Code]    : see 'blk'        :
  263.     endif            : terminate conditional    :
  264.     endm            : terminate macro def.    :
  265. symbol:    equ            : define symbol        : sysbase equ 4
  266.     else            : conditional assembly    :
  267.     even            : align PC to even    :
  268.     end            : end of source        :
  269.     globl            : global symbol (link)    :
  270.     if Expression        : conditional assembly    :
  271.     illegal            : breakpoint $4AFC    :
  272.     incbin "Filename"    : include file in object: incbin "Data"
  273.     incbin "Filename",Adr    : load file to Adr    : incbin "A",$50000
  274.     list            : assembly listing on    :
  275.     load Address        : assemble to 'Address'    : load $50000
  276. symbol:    macro            : start macro definition: flop: macro
  277.     nlist            : assembly listing off    :
  278.     odd            : align PC to odd    :
  279.     org Address        : generate absolute code:
  280.     page            : listing -> new page    :
  281.     plen pagelen        : set page length    : page 66
  282.     pwid pagewid        : set page width    : pwid 70
  283.     pinit expression    : init page settins    :
  284.     section name,type    : code,code_c,bss,bss_c    : section aa,BSS_C
  285.  
  286. 68020 instructions supported:
  287. -----------------------------
  288.     index scale:    eg. move.w (a0,d0.w*4),d0
  289.        DIVs.L
  290.     DIVsL.L
  291.     EXTB.L
  292.     MOVEC            Rc: SFC,DFC,CACR,USP,VBR,CAAR,MSP,ISP
  293.     MOVES
  294.     MULs.L
  295.     MULs.L
  296.     RTD
  297.     TST    An/D16(PC)/D8(PC,Rn)
  298.  
  299. ============================================================================
  300.  
  301. Änderungen von Version 1.83 bis Version  1.89 :
  302.  
  303. Chip & Fastmem-Anzeige ist nun nicht mehr verdreht (Funktion H).
  304. Absturz nach Aufruf der Dos-Routine (OUTPUT) ist behoben.Andere Seka-Versionen
  305. sind davon alle immernoch betroffen,sofern sie als Process laufen.
  306. Kalkulations-Routine ist übersichtlicher gestaltet.
  307. Die Pfade für die File-Requester sind von 16 auf 36 vergrößert.(Eingabe-Länge)
  308.  
  309. Wird bei der Funktion q$50000 ausgelöst + die linke Maustaste gedrückt (die ganze
  310. Zeit über),so befindet man sich im Real-Time Monitor,bis die Taste wieder
  311. losgelassen wird.
  312.  
  313. Bei Eingabe von q$50000 + rechte Maustaste wird der Ganze Speicher schnell
  314. durchgescrollt ! Mit Ctrl S stoppen mit Ctrl Q weiter mit Ctrl C beenden !
  315.  
  316.                             GRUSS T.J.
  317. Versionsänderung von V1.90 nach V1.93:
  318.  
  319. Bottblock-Checksumme ist jetzt wieder in Ordnung ! (Befehl bxxxxx)
  320. Im Befehl h steht zusätzlich die 1. und 2.Bitplane vom angewählten Screen !
  321. Direktories werden mit *­­­­­> angezeigt. (Geschmackssache) !
  322.  
  323.